home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / laston13.zip / LASTON.DOC < prev    next >
Text File  |  1991-11-04  |  6KB  |  157 lines
  1.  
  2.                                   LASTON
  3.                          RBBS Callers File Lister
  4.                                   v1.30
  5.                                 11-04-91
  6.                               by Tom Collins
  7.  
  8. |    Changes
  9. |    -------
  10.  
  11. |    Changes between LASTON v1.30 and LASTON v1.20 are highlighted with a
  12. |    vertical bar in the left column.
  13.  
  14.      What
  15.      ----
  16.  
  17.      LASTON is a small utility that will read your callers file and create
  18.      a bulletin containing the last several callers to your BBS.  Text,
  19.      ASCII, and ANSI graphics versions are created, and the number of
  20.      callers listed and the callers file name can be customized by the
  21.      user.  In addition, the display colors for the ANSI output file are
  22.      configurable, and users can be "excluded" from the output list.
  23.  
  24.      Using it
  25.      --------
  26.  
  27.      Using LASTON is pretty annoying:
  28.  
  29.         LASTON <Callers> [/ODx] [/NCx] [/Xn] [/DD] [/FCx] [/TCx]
  30.                [/UCx] [/CCx] [/DCx]
  31.  
  32.      The /OD parameter tells LASTON where to put its output files.  The
  33.      output files are always named the same, but this parameter sets the
  34.      drive and directory where it puts 'em.  A backslash will be added, if
  35.      required.  By default, LASTON puts the output files in the current
  36.      directory.
  37.  
  38.      The /NC parameter, if used, tells LASTON how many previous callers
  39.      to list (1 <= x <= 25).  The callers file name must be supplied.
  40.  
  41.      The /X parameter gives LASTON the name of someone to eXclude from the
  42.      list.  Use an underline to designate a space in a user's name, i.e.
  43.      /XTom_Collins.  Case (upper or lower) is unimportant.  You can also
  44.      use the /X parameter to get LASTON to read a file of names to exclude.
  45.      Begin the filename with a '@', i.e. /X@EXCLUDED.LST will cause LASTON
  46.      to read EXCLUDED.LST for the names to exclude.  Enter one name per
  47.      line in this file.  Up to 20 callers can be excluded.
  48.  
  49.      Use /DD to tell LASTON to display duplicate successive callers.  If,
  50.      for example, Joe Blow calls five times in a row, and /DD is specified,
  51.      Joe will be listed in the output files five times.  If no /DD is used,
  52.      Joe will only show up once.  This is the default.
  53.  
  54.      The /FC, /TC, /UC, /CC and /DC parameters set the ANSI file output
  55.      colors.  The string specified after the /xC is bracketed with ESC [ at
  56.      the beginning, and an m at the end to form an ANSI color string.  So,
  57.      to set a frame color of bright yellow, you'd put /FC1;33 to generate
  58.      .  The colors are:
  59.  
  60.         /FC - color of the Frame around the displayed users.
  61.         /TC - Title color.  The "The last 10 callers were..." line.
  62.         /UC - User's name color.
  63.         /CC - color of the user's City and state.
  64.         /DC - color of the user's Date and time on.
  65.  
  66.      To obtain the ANSI color equivalents, consult your DOS manual.
  67.  
  68.      Running LASTON with no parameters displays a help screen.
  69.  
  70.      The '/' parameters can be in any order.
  71.  
  72.      LASTON will generate three output files, called LASTON, LASTONG, and
  73.      LASTONC.  You should copy or rename these to something that your users
  74.      can view.  On the MSFA BBS, we copy them to the PRELOG file, though
  75.      it could be just as easily appended to your WELCOME file(s).
  76.  
  77.      Examples
  78.      --------
  79.  
  80.      1.  Display the last 5 callers.
  81.  
  82.          LASTON callers
  83.  
  84.      2.  Display the last 10 callers, and make the frame bright blue.
  85.  
  86.          LASTON callers /NC10 /FC1;34
  87.  
  88.      3.  Display the last 20 callers, and display the same user multiple
  89.          times if he/she called multiple times in a row.
  90.  
  91.          LASTON c:\rbbs\callers /DD /NC20
  92.  
  93.      4.  Display the last 5 callers, except when Tom Collins calls.
  94.  
  95.          LASTON callers /XTom_COLLIns
  96.  
  97.      Latest Version
  98.      --------------
  99.  
  100.      The latest version of LASTON is always available on the MSFA BBS
  101.      (301-536-1935, FidoNet 1:261/1047) for P)ersonal download or file
  102.      request.
  103.  
  104. |    Version 1.30
  105. |    ------------
  106.  
  107. |    LASTON version 1.30 is a small enhancement that deals properly with
  108. |    RBBS v17.3C's logging format (it uses BPS instead of BAUD in the
  109. |    callers file).  The problem was first noted by SysOp Sam Coleman and
  110. |    originally fixed by another SysOp (whose name I forgot to write down -
  111. |    sorry 'bout that).  Version 1.30 is the "official" fix, identical to
  112. |    the one that Sam sent me.
  113.  
  114.      Version 1.20
  115.      ------------
  116.  
  117.      LASTON version 1.20 adds the following enhancements and changes:
  118.  
  119.        o  LASTON is now somewhat faster in reading the CALLERS file.
  120.  
  121.        o  The /OD parameter was added.
  122.  
  123.        o  /X can now read a list of names to exclude.
  124.  
  125.        o  A bug in the writing of the color output file was fixed.  It
  126.        seems that if a background color was selected on the command line,
  127.        LASTONC produced a rather strange looking output.
  128.  
  129.        o  The dupe-checking for duplicate last callers was enhanced, and
  130.        LASTON should NEVER show duplicates anymore (It previously did if an
  131.        excluded name logged on between successive non-excluded users, or a
  132.        person logged on with "Access Denied").
  133.  
  134.      All of the changes in v1.20 were suggested by RBBS SysOp Sam Coleman.
  135.  
  136.      Bugs
  137.      ----
  138.  
  139.      LASTON has no bugs.  However, if you find that LASTON needs an
  140.      "enhancement," feel free to fix it yourself and send me the change.
  141.  
  142.      Source Code
  143.      -----------
  144.  
  145.      The source code, written in TurboC, is included.
  146.  
  147.      Guarantees
  148.      ----------
  149.  
  150.      LASTON will never crash your system or delete or overwrite files.
  151.      Usually.
  152.  
  153.      Good Luck!
  154.  
  155.      -- Tom Collins
  156.  
  157.